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Foreword 



id , 



This Technical Specification has been produced by the 3 Generation Partnership Project (3GPP). 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

x the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 



Introduction 



rd , 



The present document is part of a TS-family covering the 3 Generation Partnership Project; Technical Specification 
Group Services and System Aspects; Telecommunication management; as identified below: 

TS 32.331 "Notification Log (NL) Integration Reference Point (IRP): Requirements". 

TS 32.332 "Notification Log (NL) Integration Reference Point (IRP): Information Service (IS)". 

TS 32.333 "Notification Log (NL) Integration Reference Point (IRP): Common Object Request Broker 

Architecture (CORBA) Solution Set (SS)". 

TS 32.334 "Notification Log (NL) Integration Reference Point (IRP): Common Management Information 

Protocol (CMIP) Solution Set (SS)". 

TS 32.335 "Notification Log (NL) Integration Reference Point (IRP): extensible Markup Language (XML) 

solution definitions". 
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Scope 



The present document specifies the CORBA Solution Set for the IRP whose semantics are specified in 3GPP TS 32.332 
[6] Notification Log IRP: Information Service. 

Clause 1 to 3 provides background information. Clause 4 provides key architectural features supporting the SS. 
Clause 5 defines the mapping of operations, notification, parameters and attributes defined in IS to their SS equivalents. 
Clause 6 describes the notification interface containing the push method. Annex A contains the IDL specification. 

This Solution Set specification is related to TS 32.332 V6.2.X. 



References 



The following documents contain provisions which, through reference in this text, constitute provisions of the present 
document. 

• References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including 
a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same 
Release as the present document. 

[1] OMG TC Document telecom/98-1 1-01: "OMG Notification Service". 

http://www.omg.org/technology/documents/ 

[2] OMG CORBA Services: "Common Object Services Specification, Update: November 22, 1996" 

(Clause 4 contains the Event Service specification), http://www.omg.org/technology/documents/ 

[3] 3GPP TS 32.311: "Telecommunication management; Generic Integration Reference Point (IRP) 

management; Requirements". 

[4] 3GPP TS 32.302: "Telecommunication management; Configuration Management (CM); 

Notification Integration Reference Point (IRP): Information Service (IS)". 

[5] 3GPP TS 32.303: " Telecommunication management; Configuration Management (CM); 

Notification Integration Reference Point (IRP): Common Object Request Broker Architecture 
(CORBA) Solution Set (SS)". 

[6] 3GPP TS 32.332: "Telecommunication management; Notification Log (NL) Integration Reference 

Point (IRP): Information Service (IS)". 

[7] 3GPP TS 32.312: "Telecommunication management; Generic Integration Reference Point (IRP) 

Management; Information Service (IS)". 



3 Definitions and abbreviations 

3.1 Definitions 

For the purposes of the present document, the terms and definitions given in TS 32.332 [6] apply. 
IRP document version number string (or "IRPVersion"): See 3GPP TS 32.31 1 [3] subclause 3.1. 
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3.2 



Abbreviations 



For the purposes of the present document, the following abbreviations apply: 

CORBA Common Object Request Broker Architecture 

IDL Interface Definition Language 

IRP Integration Reference Point 

MOC Managed Object Class 

MOI Managed Object Instance 

NE Network Element 

OMG Object Management Group 



4 Architectural Features 

The overall architectural feature of Notification Log IRP is specified in 3GPP TS 32.332 [6]. This clause specifies 
features that are specific to the CORBA SS. 



4.1 



Notification Services 



In implementations of CORBA SS, IRP Agent conveys Notification Log notifications to IRPManager via OMG 
Notification Service (OMG Notification Service [1]). 

OMG Event Service [2] provides event routing and distribution capabilities. OMG Notification Service provides, in 
addition to Event Service, event filtering and Quality Of Service (QOS). 

A necessary and sufficient subset of OMG Notification Services shall be used to support Notification Log notifications 
as specified in 3GPP TS 32.332 [6]. 

These operation are classified as «AgentInternal-usage» in GPP TS 32.332 [6]. 



5. Mapping 

5.1 Operation and Notification mapping 

3GPP TS 32.332 [6] defines semantics of operations and notifications visible across the Notification Log IRP. 

The following table indicates the mapping of these operations and notifications to their equivalents defined in this SS. 

Table 5.1.1 : Mapping from IS Notification/Operation to SS equivalents 



IS Operation/ notification 
3GPP TS 32.332 [6] 


SS Method 


Qualifier 


subscribeLog 


subscribe log 


M 


unsubscribeLog 


unsubscribe log 


M 


exportLog Records 


export log records 


O 


getLogRecords 


get log records 


O 


getLogSubscriptionlds 


get log subscription ids 


O 


getLogSubscriptionStatus 


get log subscription status 


O 


notifyLogSubscribed 


push_structured_event (note 1). See clause 4.1. 
See interface NotifyLogSubscribed 


M 


notifyLogUnsubscribed 


push_structured_event (note 1). See clause 4.1. 
See interface NotifyLogUnubscribed 


M 


notifyOccupancyLevelCrossed 


push_structured_event (note 1). See clause 4.1 . 
See interface NotifyLogOccupancyLevelCrossed 


O 


notifyLoggingResumed 


push_structured_event (note 1). See clause 4.1. 
See interface NotifyLoggingResumed 


O 


NOTE: OMG Notification Service OMG Notification Service [1] defines this method. 
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5.2 Operation parameter mapping 



3GPP TS 32.332 [6] defines semantics of parameters carried in operations across the Notification Log IRP. 

The following tables indicate the mapping of these parameters, as per operation, to their equivalents defined in this SS. 

Table 5.2.1 : Mapping from IS subscribeLog parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


logSubscriptionld 


NotificationLoglRPConstDefs::LogSubscriptionld logSubscriptionld 


M 


loggingEndTlme 


GenericlRPManagementConstDefs::IRPTime 
loggingEndTimeAsked 


O 


notificationCategories 


GenericlRPManagementConstDefs::NotificationCategorySet 
notificationCategorySet 


O 


filter 


GenericlRPManagementConstDefs::StringOpt filter 


O 


logManagerToken 


NotificationLoglRPConstDefs::LogManagerTokenOpt 
logManagerToken; 


O 


loggingEndTime 


GenericlRPManagementConstDefs::loggingEndTimeGiven 





status 


GenericlRPManagementConstDefs::Signal 

Exceptions: 

SubscribeLog, GenericlRPManagementSystem::lnvalidParameter, 

Genericl RPManagementSystem : :ParameterNotSupported, 

GenericlRPManagementSystem::ValueNotSupported, 

InvalidLogSubscriptionld, UnknownLogManagerToken. 


M 



Table 5.2.2: Mapping from IS unsubscribeLog parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


logSubscriptionld 


NotificationLoglRPConstDefs::LogSubscriptionld logSubscriptionld 


M 


logManagerToken 


NotificationLoglRPConstDefs::LogManagerTokenOpt 
logManagerToken 


O 


status 


Genericl RPManagementConstDefs::Signal 

Exceptions: 

UnsubscribeLog, 

Genericl RPManagementSystem ::lnvalidParameter, 

GenericlRPManagementSystem::ParameterNotSupported, 

UnknownLogSubscriptionld, UnknownLogManagerToken). 


M 



Table 5.2.3: Mapping from IS exportLogRecords parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


logSubscriptionld 


NotificationLoglRPConstDefs::LogSubscriptionld logSubscriptionld 


M 


notificationCategories 


NotificationLoglRPConstDefs::NotificationCategorySetOpt 
notificationCategorySet 


O 


filter 


GenericlRPManagementConstDefs::StringOpt filter 


O 


invocationld 


string invocationld 


M 


status 


GenericlRPManagementConstDefs::Signal 

Exceptions: 

ExportLogRecords, Genericl RPManagementSystem ::lnvalidParameter, 

GenericlRPManagementSystem::ParameterNotSupported, 

GenericlRPManagementSystem::OperationNotSupported, 

UnknownLogSubscriptionld. 


M 
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Table 5.2.4: Mapping from IS getLogRecords parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


logSubscriptionld 


NotificationLoglRPConstDefs::LogSubscriptionld 
logSubscriptionld 


M 


notificationCategories 


NotificationLoglRPConstDefs::NotificationCategorySetOpt 
notificationCategories, 


O 


filter 


GenericlRPManagementConstDefs::StringOpt filter 


O 


getLogRecordsResult 


Some or all of the information contained in getLogRecordsResult 
will be returned via the return value of type 
DsLogAdmin::RecordList. 


M 


status 


Exceptions: 

GetLogRecords, 

GenericlRPManagementSystem::lnvalidParameter, 

GenericlRPManagementSystem::ParameterNotSupported, 

GenericlRPManagementSystem::ValueNotSupported, 

GenericlRPManagementSystem::OperationNotSupported, 

UnknownLogSubscriptionld. 


M 



Table 5.2.5: Mapping from IS getLogSubscriptionids parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


logSubscriptionlds 


return value of type DsLogAdmin::LogldList 


M 


status 


Exceptions: 

GetLogSubscriptionids, 

GenericlRPManagementSystem::OperationNotSupported. 


M 



Table 5.2.6: Mapping from IS getLogSubscriptionStatus parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


logSubscriptionld 


NotificationLoglRPConstDefs::LogSubscriptionld 
logSubscriptionld 


M 


logAttributeList 


NotificationLoglRPConstDefs::LogAttributeList logAttributeList 


M 


status 


GenericlRPManagementConstDefs::Signal 

Exceptions: 

GetLogSubscriptionStatus, 

GenericlRPManagementSystem::lnvalidParameter, 

GenericlRPManagementSystem::OperationNotSupported. 


M 



5.3 Notification parameter mapping 



3GPP TS 32.332 [6] defines semantics of parameters carried in notifications. The following tables indicate the mapping 
of these parameters to their OMG CORBA Structured Event (defined in OMG Notification Service [1]) equivalents. 
The composition of OMG Structured Event, as defined in the OMG Notification Service [1], is: 



Header 



3ody 



Fixed Header 

domain_name 

type_name 

event_name 
Variable Header 

f i Iter able_body_fie Ids 
remaining_body 



The following tables list all OMG Structured Event attributes in the second column. The first column identifies the 
3GPP TS 32.332 [6] defined notification parameters. 
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Table 5.3.1 : Mapping for notifyLogSubscribed 



IS Parameters 


OMG CORBA 

Structured Event 

attribute 


Qualifier 


Comment 


There is no 
corresponding IS 
parameter. 


domain_name 


M 


It carries the IRP document version number string. See sub-clause 3.3. 
It indicates the syntax and semantics of the Structured Event as defined by 
this specification. 


notificationType 


type_name 


M 


This is the NotificationLoglRPNotifications:: NotifyLogSubscribed:: 
NOTIFY LOG SUBSRIBED. 


There is no 
corresponding IS 
parameter. 


event_name 


M 


Null-string 


There is no 
corresponding IS 
parameter. 


variable Header 






objectClass, 
objectlnstance 


One NV (note 1) pair 

of 

filterable_body_fields 


M 


Name of NV pair is the NotificationlRPConstDefs:: AttributeNameValue:: 
MANAGED_OBJECT_INSTANCE. 

Value of NV pair is a string. 


notificationld 


One NV pair of 
remaining_body 


M 


Name of NV pair is the NotificationlRPConstDefs:: AttributeNameValue:: 
NOTIFICATIONJD. 

Value of NV pair is a long. 


eventTime 


One NV pair of 
filterable_body_fields 


M 


Name of NV pair is the NotificationlRPConstDefs:: AttributeNameValue:: 
EVENT_TIME. 

Value of NV pair is of type GenericlRPManagementConstDefs::IRPTime. 


systemDN 


One NV pair of 
filterable_body_fields 


M 


Name of NV pair is the NotificationlRPConstDefs:: AttributeNameValue:: 
SYSTEM_DN 

Value of NV pair is a string. 


logSubscriptionld 


One NV pair of 
remaining_body 


M 


Name of NV pair is the NotificationLoglRPNotifications:: 
NotifyLogSubscribed::LOG_SUBSCRIPTION_ID. 

Value of NV pair is of type NotificationLoglRPConstDefs::LogSubscriptionld. 


loggingEndTime 


One NV pair of 
remaining_body 


O 


Name of NV pair is the 
NotificationLoglRPNotifications::NotifyLogSubscribed::LOGGING_END_TIME. 

Value of NV pair is a string. 


notificationCategories 


One NV pair of 
remaining_body 


O 


Name of NV pair is the NotificationLoglRPNotifications:: 
NotifyLogSubscribed::NOTIFICATION_CATEGORIES. 

Value of NV pair is of type 
GenericlRPManagementConstDefs::VersionNumberSet. 


filter 


One NV pair of 
remaining_body 


O 


Name of NV pair is notificationLoglRPNotifications:: NotifyLogSubscribed:: 
FILTER 

Value of NV pair is a string. 


NOTE: NV stands for name-value pair. Order arrangement of NV pairs is not significant. The name of NV-pair is always encoded 
in string. This note is applicable to all NV-pairs and all mapping tables for all notifications. 
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Table 5.3.2: Mapping for notifyLogUnsubscribed 



IS Parameters 


OMG CORBA 

Structured Event 

attribute 


Qualifier 


Comment 


There is no 
corresponding IS 
parameter. 


domain_name 


M 


It carries the IRP document version number string. See 
sub-clause 3.3. 

It indicates the syntax and semantics of the Structured 
Event as defined by this specification. 


notificationType 


type_name 


M 


This is the NotificationLoglRPNotifications:: 
NotifyLogSubscribed:: NOTIFY LOG UNSUBSCRIBED. 


There is no 
corresponding IS 
parameter. 


event_name 


M 


Null-string. 


There is no 
corresponding IS 
parameter. 


variable Header 






objectClass, 
objectlnstance 


One NV pair of 
filterable_body_fields 


M 


Name of NV pair is the NotificationlRPConstDefs:: 
AttributeNameValue::MANAGED_OBJECT_INSTANCE. 

Value of NV pair is a string. 


notificationld 


One NV pair of 
remaining_body 


M 


Name of NV pair is the NotificationlRPConstDefs:: 
AttributeNameValue::NOTIFICATION_ID. 

Value of NV pair is a long. 


eventTime 


One NV pair of One NV 
pair of 
filterable_body_fields 


M 


Name of NV pair is the NotificationlRPConstDefs:: 
AttributeNameValue:: EVENTTIME. 

Value of NV pair is a IRPTime of module 
GenericlRPManagementConstDefs. 


systemDN 


One NV pair of 
filterable_body_fields 


M 


Name of NV pair is the NotificationlRPConstDefs:: 
AttributeNameValue:: SYSTEM_DN 

Value of NV pair is a string. 


logSubscriptionld 


One NV pair of 
filterable_body_fields 
(editor note) 


M 


Name of NV pair is the NotificationLoglRPNotifications:: 
NotifyLogSubscribed:: LOG_SUBSCRIPTION_ID. 

Value of NV pair is of type 
NotificationLoglRPConstDefs::LogSubscriptionld. 



Editor note: The placement of this parameter in filterable_body_fields so that it is filterable is not yet aligned with 
current IS and require further discussion. 
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Table 5.3.3: Mapping for notifyOccupancyLevelCrossed 



IS Parameters 


OMG CORBA 

Structured Event 

attribute 


Qualifier 


Comment 


There is no 
corresponding IS 
parameter. 


domain_name 


M 


It carries the IRP document version number string. See 
sub-clause 3.3. 

It indicates the syntax and semantics of the Structured 
Event as defined by this specification. 


notificationType 


type_name 


M 


This is the NotificationLoglRPNotifications:: 

NotifyLogSubscribed:: 

NOTIFY LOG OCCUPANCY LEVEL CROSSED. 


There is no 
corresponding IS 
parameter 


event_name 


M 


Null-string 


There is no 
corresponding IS 
parameter. 


variable Header 






objectClass, 
objectlnstance 


One NV pair of 
filterable_body_fields 


M 


NV stands for name-value pair. Order arrangement of NV 
pairs is not significant. The name of NV-pair is always 
encoded in string. 

Name of NV pair is the NotificationlRPConstDefs:: 
AttributeNameValue::MANAGED_OBJECT_INSTANCE. 

Value of NV pair is a string. 


notificationld 


One NV pair of 
remaining_body 


M 


Name of NV pair is the NotificationlRPConstDefs:: 
AttributeNameValue::NOTIFICATION_ID. 

Value of NV pair is a long. 


eventTime 


One NV pair of 
filterable_body_fields 


M 


Name of NV pair is the NotificationlRPConstDefs:: 
AttributeNameValue:: EVENTTIME. 

Value of NV pair is a IRPTime of module 
GenericlRPManagementConstDefs. 


systemDN 


One NV pair of 
filterable_body_fields 


M 


Name of NV pair is the NotificationlRPConstDefs:: 
AttributeNameValue:: SYSTEM_DN 

Value of NV pair is a string. 


logSubscriptionld 


One NV pair of 
filterable_body_fields 


M 


Name of NV pair is the NotificationLoglRPNotifications:: 
NotifyLogSubscribed:: LOG_SUBSCRIPTION_ID. 

Value of NV pair is of type 
NotificationLoglRPConstDefs::LogSubscriptionld. 


currentOccupancyLevel 


One NV pair of One NV 
pair of 
filterable_body_fields 


M 


Name of NV pair is the NotificationLoglRPNotifications:: 
NotifyLogSubscribed:: CURRENT_OCCUPANCY_LEVEL. 

Value of NV pair is an unsigned short (i.e. DsLogAdmin:: 
Threshold). 


logFullAction 


One NV pair of 
filterable_body_fields 


M 


Name of NV pair is the NotificationLoglRPNotifications:: 
NotifyLogSubscribed:: LOG_FULL_ACTION. 

Value of NV pair is of type NotificationLoglRPConstDefs:: 
LogFullActionType. 
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Table 5.3.4: Mapping for notifyLoggingResumed 



IS Parameters 


OMG CORBA 

Structured Event 

attribute 


Qualifier 


Comment 


There is no 
corresponding IS 
parameter. 


domain_name 


M 


It carries the IRP document version number string. See sub-clause 3.3. 
It indicates the syntax and semantics of the Structured Event as defined by 
this specification. 


notificationType 


type_name 


M 


This is the NotificationLoglRPNotifications:: NotifyLogSubscribed:: 
NOTIFY LOG SUBSRIBED. 


There is no 
corresponding IS 
parameter. 


event_name 


M 


Null-string 


There is no 
corresponding IS 
parameter. 


variable Header 






objectClass, 
objectlnstance 


One NV (note 1) pair 

of 

filterable_body_fields 


M 


Name of NV pair is the NotificationlRPConstDefs:: AttributeNameValue:: 
MANAGED_OBJECT_INSTANCE. 

Value of NV pair is a string. 


notificationld 


One NV pair of 
remaining_body 


M 


Name of NV pair is the NotificationlRPConstDefs:: AttributeNameValue:: 
NOTIFICATIONJD. 

Value of NV pair is a long. 


eventTime 


One NV pair of 
filterable_body_fields 


M 


Name of NV pair is the NotificationlRPConstDefs:: AttributeNameValue:: 
EVENT_TIME. 

Value of NV pair is of type GenericlRPManagementConstDefs::IRPTime. 


systemDN 


One NV pair of 
filterable_body_fields 


M 


Name of NV pair is the NotificationlRPConstDefs:: AttributeNameValue:: 
SYSTEM_DN 

Value of NV pair is a string. 


logSubscriptionld 


One NV pair of 
remaining_body 


M 


Name of NV pair is the NotificationLoglRPNotifications:: 
NotifyLogSubscribed::LOG_SUBSCRIPTION_ID. 

Value of NV pair is of type NotificationLoglRPConstDefs::LogSubscriptionld. 


loggingEndTime 


One NV pair of 
remaining_body 


O 


Name of NV pair is the 
NotificationLoglRPNotifications::NotifyLogSubscribed::LOGGING_END_TIME. 

Value of NV pair is a string. 


notificationCategories 


One NV pair of 
remaining_body 


O 


Name of NV pair is the NotificationLoglRPNotifications:: 
NotifyLogSubscribed::NOTIFICATION_CATEGORIES. 

Value of NV pair is of type 
GenericlRPManagementConstDefs::VersionNumberSet. 


filter 


One NV pair of 
remaining_body 


O 


Name of NV pair is notificationLoglRPNotifications:: NotifyLogSubscribed:: 
FILTER 

Value of NV pair is a string. 


NOTE: NV stands for name-value pair. Order arrangement of NV pairs is not significant. The name of NV-pair is always encoded 
in string. This note is applicable to all NV-pairs and all mapping tables for all notifications. 
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6 NotificationLoglRPNotifications Interface 

OMG CORBA Notification push operation is used to realise the notification of 

Notif icationLoglRPNotif ications. All the notifications in this interface are implemented using this 

push_structured_event method. 

6.1 Method push (M) 

module CosNotifyComm { 

Interface SequencePushConsumer : NotifyPublish { 

void push_structured_events ( 

in CosNotif ication : : EventBatch notifications) 

raises ( CosEventComm: : Disconnected) ; 

}; // SequencePushConsumer 



}; // CosNotifyComm 

NOTE 1: The push_structured_events method takes an input parameter of type EventBatch as defined 
in the OMG CosNotif ication module (OMG Notification Service [1]). This data type is the same as 
a sequence of Structured Events. Upon invocation, this parameter will contain a sequence of Structured 
Events being delivered to IRPManager by IRP Agent to which it is connected. 

NOTE 2: The maximum number of events that will be transmitted within a single invocation of this operation is 
controlled by IRP Agent wide configuration parameter. 

NOTE 3: The amount of time the supplier (IRP Agent) of a sequence of Structured Events will accumulate 
individual events into the sequence before invoking this operation is controlled by IRP Agent wide 
configuration parameter as well. 

NOTE 4: IRP Agent may push EventBatch with only one Structured Event. 
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Annex A (normative): 
IDL specifications 

A.1 IDL specification (file name 

"NotificationLoglRPConstDefs.idl") 

// File: NotificationLoglRPConstDefs . idl 

#ifndef _NOTIFICATIONLOGIRPCONSTDEFS_IDL_ 
#define _NOTIFICATIONLOGIRPCONSTDEFS_IDL_ 

#ifndef _DSLOGADMIN_IDL_ 
#define _DSLOGADMIN_IDL_ 
#include <DsLogAdmin . idl> 
#endif // _DSLOGADMIN_IDL_ 

#include "Notif icationlRPConstDef s . idl" 
#include "GenericIRPManagementConstDef s . idl" 

// This statement must appear after all include statements 
#pragma prefix "3gppsa5.org" 

module NotificationLoglRPConstDefs 



typedef DsLogAdmin : : Logld LogSubscriptionld; 
typedef DsLogAdmin :: Recordld Recordld; 
typedef DsLogAdmin :: RecordldList RecordldList ; 

typedef string LogManagerToken; 

/* 

LogManagerTokenOpt is a type carrying an optional parameter. 

If the boolean is TRUE, then the value is present; else absent 

*/ 

union LogManagerTokenOpt switch (boolean) 

{ 

case TRUE: LogManagerToken value; 



/* 

IRPTimeOpt is a type carrying an optional parameter. 

If the boolean is TRUE, then the value is present; else absent 

*/ 

union IRPTimeOpt switch (boolean) 

{ 

case TRUE: GenericIRPManagementConstDef s :: IRPTime value; 



typedef GenericIRPManagementConstDef s : : VersionNumberSet 

Notif icationCategory Set ; 
/* 

Notif icationCategorySetOpt is a type carrying an optional parameter. 
If the boolean is TRUE, then the value is present; else absent. 
*/ 

union Notif icationCategorySetOpt switch (boolean) 
{ 
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case TRUE: Notif icationCategorySet value; 
}; 

enum LogState { LOGGING, LOGFULL, STOPPED}; 

typedef DsLogAdmin: : CapacityAlarmThresholdList 
CapacityAlarmThresholdList ; 

typedef unsigned short LogFullActionType; 
const LogFullActionType wrap = 0; 
const LogFullActionType halt = 1; 

/* 

IteratorOpt is a type carrying an optional parameter. 

If the boolean is TRUE, then the value is present; else absent. 

*/ 

union IteratorOpt switch (boolean) 

{ 

case TRUE: DsLogAdmin :: Iterator value; 

}; 

struct LogAttributes { 

LogSub script ion Id logSubscriptionld; 

GenericIRPManagementConstDef s : :IRPTime loggingEndTime; 

unsigned long long maxSize; 

unsigned long long currentSize; 

LogState logState; 

unsigned long long logRecordCount ; 

Notif icationlRPConstDefs : : Notif icationCategorySet notif icationCategories ; 

string filter; 

LogFullActionType logFullAction; 

CapacityAlarmThresholdList occupancy Levels ; 

}; 
typedef sequence <LogAttributes> LogAttributeList ; 



}; 



#endif // _NOTIFICATIONLOGIRPCONSTDEFS_IDL_ 
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A.2 IDL specification (file name 'NotificationLoglRPSystem.ioT) 

// File: Notif icationLoglRPSystem. idl 

#ifndef _NOTIFICATIONLOGIPRSYSTEM_IDL_ 
#define _NOTIFICATIONLOGIRPSYSTEM_IDL_ 

#include "Notif icationLoglRPConstDefs . idl" 

#include "GenericIRPManagementSystem. idl" 

#include <TimeBase . idl> 

#ifndef _DSLOGADMIN_IDL_ 

#define _DSLOGADMIN_IDL_ 

#include <DsLogAdmin . idl> 

#endif // _DSLOGADMIN_IDL_ 

// This statement must appear after all include statements 
#pragma prefix "3gppsa5.org" 

module Notif icationLoglRPSystem 
{ 

/* 

System fails to complete the method. System can provide reason 

to qualify the exception. The semantics carried in reason 

is outside the scope of this IRP . 

*/ 

exception SubscribeLog { string reason; }; 

exception UnsubscribeLog { string reason; }; 

exception ExportLogRecords { string reason; }; 

exception GetLogSubscriptionlds { string reason; }; 

exception GetLogRecords { string reason; }; 

exception GetLogSubscriptionStatus { string reason; }; 

exception InvalidLogSubscriptionld { string reason; }; 

exception UnknownLogSubscriptionld {}; 

exception UnknownLogManagerToken {}; 

exception InvalidConstraint { string reason; }; 



interface Notif icationLogIRP : GenericIRPManagementSystem:: 
GenericIRPManagement 



{ 



GenericIRPManagementConstDef s :: Signal subscribe_log ( 

in Notif icationLoglRPConstDef s : : LogSubscriptionld logSubscriptionld, 
in Notif icationLoglRPConstDef s :: IRPTimeOpt loggingEndTimeAsked, 
in Notif icationLoglRPConstDef s : : Notif icationCategorySetOpt 

notif icationCategory Set, 
in GenericIRPManagementConstDef s :: StringOpt filter, 
out Notif icationLoglRPConstDef s : : LogSubscriptionld 

1 ogSub script ion I dOut , 
out Notif icationLoglRPConstDef s : : LogManagerTokenOpt logManagerToken, 
out Notif icationLoglRPConstDef s :: IRPTimeOpt loggingEndTimeGiven 
) 
raises ( SubscribeLog, 

GenericIRPManagementSystem: : InvalidParameter, 
GenericIRPManagementSystem: : ParameterNot Supported, 
GenericIRPManagementSystem: : ValueNot Supported, 
InvalidLogSubscriptionld, UnknownLogManagerToken 

); 

GenericIRPManagementConstDef s :: Signal unsubscribe_log ( 
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in Notif icationLoglRPConstDef s : : LogSubscriptionld logSubscriptionld, 
in Notif icationLoglRPConstDef s : : LogManagerTokenOpt logManagerToken 
) 
raises ( UnsubscribeLog, 

GenericIRPManagementSystem: : InvalidParameter, 
Generic IRPManagement System: : ParameterNot Supported, 
UnknownLogSubscriptionld, UnknownLogManagerToken) ; 

GenericIRPManagementConstDef s :: Signal export_log_records ( 

in Notif icationLoglRPConstDef s : : LogSubscriptionld logSubscriptionld, 
in Notif icationLoglRPConstDef s : : Notif icationCategorySetOpt 

notif icationCategory Set, 
in GenericIRPManagementConstDef s :: StringOpt filter, 
out string invocationld 
) 
raises ( ExportLogRecords, 

GenericIRPManagementSystem: : InvalidParameter, 
GenericIRPManagementSystem: : ParameterNot Supported, 
GenericIRPManagementSystem: : Ope r at ionNot Supported, 
UnknownLogSubscriptionld) ; 

// If some but not all of the information is returned via the return value 
// RecordList, then the rest of the information is returned via the 
// iterator. Otherwise, the iterator is absent. 
// 
DsLogAdmin: : RecordList get_log_records ( 

in Notif icationLoglRPConstDef s : : LogSubscriptionld logSubscriptionld, 
in Notif icationLoglRPConstDef s : : Notif icationCategorySetOpt 

notif icationCategories, 
in GenericIRPManagementConstDef s :: StringOpt filter, 
out Notif icationLoglRPConstDef s :: IteratorOpt iterator 
) 
raises ( GetLogRecords, 

GenericIRPManagementSystem: : InvalidParameter, 
GenericIRPManagementSystem: : ParameterNot Supported, 
GenericIRPManagementSystem: : ValueNot Supported, 
GenericIRPManagementSystem: : Ope rat ionNot Supported, 
UnknownLogSubscriptionld) ; 

DsLogAdmin: :LogIdList get_log_subscription_ids ( ) 
raises ( GetLogSubscriptionlds, 

GenericIRPManagementSystem: : Operat ionNot Supported 

); 

GenericIRPManagementConstDef s : : Signal get_log_subscription_status ( 

in Notif icationLoglRPConstDef s : : LogSubscriptionld logSubscriptionld, 

out Notif icationLoglRPConstDef s : : LogAttributeList logAttributeList 

) 

raises ( GetLogSubscriptionStatus, 

GenericIRPManagementSystem: : InvalidParameter, 
GenericIRPManagementSystem: : Ope rat ionNot Supported 



}; 

#endif // _NOTIFICATIONLOGIPRSYSTEM_IDL_ 
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A.3 IDL specification (file name 

'NotificationLoglRPNotifications.idl') 

// File: Notif icationLoglRPNotif ications . idl 

#ifndef _NOTIFICATIONLOGIRPNOTIFICATIONS_IDL_ 
#define _NOTIFICATIONLOGIRPNOTIFICATIONS_IDL_ 

#include "Notif icationlRPNotif ications . idl" 

// This statement must appear after all include statements 
#pragma prefix "3gppsa5.org" 

module Notif icationLoglRPNotif ications 
{ 

interface NotifyLogSubscribed: Notif icationlRPNotif ications : :Notify 
{ 

const string N0TIFY_L0G_SUBSRIBED = "xl"; 

const string L0G_SUBSCRIPTI0N_ID = "id"; 

const string L0GGING_END_TIME = "loggingEndTime" ; 

const string NOTIFICATION_CATEGORIES = "categories"; 

const string FILTER = "filter"; 

}; 

interface NotifyLogUnubscribed: Notif icationlRPNotif ications : :Notify 
{ 

const string N0TIFY_L0G_UNSUBSCRIBED = "x2"; 

const string L0G_SUBSCRIPTI0N_ID = "id"; 

}; 

interface Notif yLogOccupancyLevelCrossed: 

Notif icationlRPNotif ications : :Notify 
{ 

const string N0TIFY_L0G_0CCUPANCY_LEVEL_CR0SSED = "x3"; 

const string LOG_SUBSCRIPTION_ID = "id"; 

const string CURRENT_OCCUPANCY_LEVEL = "level"; 

const string L0G_FULL_ACTI0N = "f ullAction" ; 

}; 

interface NotifyLoggingResumed: Notif icationlRPNotif ications : :Notify 
{ 

const string N0TIFY_L0GGING_RESUMED = "x4"; 

const string L0G_SUBSCRIPTI0N_ID = "id"; 



}; 

#endif // _N0TIFICATI0NL0GIRPN0TIFICATI0NS_IDL_ 
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